home *** CD-ROM | disk | FTP | other *** search
/ PCDisk Magazine Disks / PCDisk Magazine - Disk 3.img / MAKESCRN.TXT < prev    next >
Encoding:
Text File  |  1984-08-01  |  7.5 KB  |  144 lines
  1.                        ADDITIONAL INFO
  2. NOTE: THE CODE USES VARIABLES THAT START WITH "S.", EG.,"S.TMP%".  YOUR
  3. CODE SHOULD NOT USE ANY SUCH VARIABLE, EXCEPT TO COMMUNICATE WITH THE
  4. PROGRAM.
  5.  
  6. DATA STATEMENTS ARE CONSTRUCTED AS FOLLOWS:
  7. 60000 DATA a,b,c,d,e,f,g,h,i
  8.    a-is the X coordinate on the screen where the prompt
  9.      should appear.  It should be a value from 2 to 79.
  10.    b-is the Y coordinate of where the prompt should appear.
  11.      This value should be from 3 to 22.  In the
  12.      initialization logic is a variable S.BOT% that
  13.      indicates the last line on the screen that should be
  14.      used.  If b is set to a negative value, it is used as
  15.      an offset from the bottom of the screen.  For
  16.      instance, if S.BOT%=24, and b=-9, then the routine
  17.      will use line 15 (24 - 9=15).
  18.    c-is the length of the input.  It should range from 1
  19.      to 80.  The resultant output will se set with either
  20.      leading or training spaces a length equal to c.
  21.    d-is the editing flag.  This is the most complicated
  22.      part of the data statement to set up.  Because of the
  23.      problem that some people have with the flag, the
  24.      software accepts two different modes of setting the
  25.      the flags - use which ever one is easier for you.
  26.  
  27.      In the first mode, the flag consists of a number ranging
  28.      from 0 to 32767.  It is created by adding together the
  29.      values listed below next to "bit" for each editing test
  30.      to be done.  For instance, if you wanted the input to be
  31.      a string of characters (alpha/numeric) that completely
  32.      fills an input field and converts any lowercase input
  33.      to uppercase, then the input flag would be 2048 (full
  34.      input) + 16 (upper case conversion) for a total of
  35.      2064.   Obviously, certain flags are illogical if used
  36.      together, and will result in inpredictable actions.
  37.  
  38.      In the second mode, the input flag field in the data
  39.      statement can be constructed with an exclamation point
  40.      (!) followed by a swries of "1" and "0", such as:
  41.                   !000010011
  42.      This would mean that the first 4 editing tests would not
  43.      be used, the fifth would be on (conversion to uppercase)
  44.      would be enabled, the next two would not be used, and
  45.      the next two would.
  46.  The editing flags are:
  47.      bit 1   Not used
  48.      bit 2   Not used
  49.      bit 4   Not used
  50.      bit 8   Not used
  51.      bit 16  Convert entered text to uppercase
  52.              Any lowercase alpha characters entered will be
  53.              converted to uppercase automatically.
  54.      bit 32  Erase field after input is completed
  55.              After a field has been processed, the field and
  56.              the data entered will be erased from the screen.
  57.      bit 64  Accept only Function keys (S.LR$ through S.HR$)
  58.              You want the user to press F1 through F9 only.
  59.              No other keys (besides F10 for HELP, and ESC)
  60.              may be pressed.  In the data statement, field
  61.              #f would contain the lowest allowed Function
  62.              key and field #g would have the highest.  These
  63.              are entered in the form of:
  64.              DATA a,b,c,d,e,F1,F7,h
  65.              if the allowed input is from F1 through F7.
  66.      bit 128 Accept only interger value (leading "-" allowed)
  67.              Accept numeric input without a decimal.
  68.      bit 256 Accept a dollar type vaule with 1 decimal allowed
  69.              Accept numeric input with a decimal allowed.
  70.              The routine will automatically format the
  71.              input to the form of: 9.99
  72.      bit 512 Accept input with range limited to S.LR$ and S.HR$
  73.              The input must be within the range specified in
  74.              fields #f and #g.  The range test can be used
  75.              with both numeric and alpha input- i.e. for
  76.              input between 1 and 5, or between A and C.
  77.      bit 1024 At least 1 character must be entered (not blank)
  78.               Self explanatory.
  79.      bit 2048 Input must be filled (i.e.-cant press RETURN))
  80.               Self explanatory.
  81.      bit 4096 Input must be one of fields in S.LR$
  82.               To force the user to enter only specific data,
  83.               such as "Y" or "N", this test can be used.  The
  84.               #f field sould contain the valid possibilities
  85.               such as "Y","N", etc. seperated by some
  86.               character specified in field #g.  For example:
  87.                 DATA a,b,c,d,e,Y/N/?/,/,h
  88.               Notice that the choices were seperated by a "/"
  89.               and that character appears in field #g.  Be sure
  90.               that the sperator follows the last choice.
  91.       bit 8192 Input must be valid date in MMDDYY format
  92.                The data to be entered will be validated as a
  93.                date.  It must be a 6 digit entry in the form
  94.                of MMDDYY.  No leap year tests are performed.
  95.                The data returned to you in S.INPUT$ and
  96.                S.DA$(FI%) will be in MMDDYY format, but the
  97.                data will be redisplayed as MM/DD/YY on the
  98.                screen.
  99.       bit 16384 Display prompt only-accept no input
  100.                 The input prompt and any data in S.DA$(FI%)
  101.                 will be displayed, but no input will be done.
  102.                 This can be used to display information on the
  103.                 screen.
  104.             e   This is the prompt to be displayed on the screen, such
  105.                 as "Enter Date:"
  106.            f&g  These two fields have varied functions depending upon
  107.                 the input validation tests chosen for that field.  See
  108.                 field #e above for more information.
  109.             h   This is the default field.  If any data is placed here,
  110.                 the system will display the default in the input field
  111.                 when the prompt is displayed.  Pressing RETURN will be
  112.                 the equivalent of having entered the data.  Of course,
  113.                 the user may enter any information to over-ride the
  114.                 default.  Be sure that your default conforms to all
  115.                 editing tests to be performed on the field.
  116.             i   This field should contain an extra HELP message.
  117.                 If the user press F10, then this message will be
  118.                 displayed at the bottom of the screen.
  119.  
  120. ADDITIONAL FEATURES:
  121.  
  122.    1.   MAKESCREEN also provides the oportunity to display information
  123.         on the screen without accepting input.  For example, in a file-
  124.         maintenance program, you might want to display the current data
  125.         in the file, then allow the user to update specific fields.  To
  126.         do this, you must read the data from your file, parse it (that
  127.         means extract each field of data from the record individually)
  128.         and put each of the fields into the proper S.DA$() variables.
  129.         Then set FI% to the negative value of the field number and
  130.         GOSUB 40000.  For example, for field #6:
  131.         FI%=-6: GOSUB 40000
  132.         This instructs the program to display both the prompt and your
  133.         parsed data on the screen for field #6.  At a later time, you
  134.         may revert to the normal technique (FI%=6) to alter the
  135.         displayed information.
  136.    
  137.    2.   Another option is to set the parsed information into the default
  138.         field with:
  139.             [LET] S.DEF$(FI%)=S.DA$(FI%)
  140.         prior to accepting input for the field.  This will allow the
  141.         operator to simply press <ENTER> if he/she wished to maintain
  142.         the current information, or to type in different data if it is
  143.         to be changed.
  144.